home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / perl5 / ExtUtils::Install.z / ExtUtils::Install
Encoding:
Text File  |  2002-10-03  |  4.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. EEEExxxxttttUUUUttttiiiillllssss::::::::IIIInnnnssssttttaaaallllllll((((3333))))                                      EEEExxxxttttUUUUttttiiiillllssss::::::::IIIInnnnssssttttaaaallllllll((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ExtUtils::Install - install files from here to there
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      uuuusssseeee EEEExxxxttttUUUUttttiiiillllssss::::::::IIIInnnnssssttttaaaallllllll;;;;
  13.  
  14.      iiiinnnnssssttttaaaallllllll(((($$$$hhhhaaaasssshhhhrrrreeeeffff,,,,$$$$vvvveeeerrrrbbbboooosssseeee,,,,$$$$nnnnoooonnnnoooonnnnoooo))));;;;
  15.  
  16.      uuuunnnniiiinnnnssssttttaaaallllllll(((($$$$ppppaaaacccckkkklllliiiissssttttffffiiiilllleeee,,,,$$$$vvvveeeerrrrbbbboooosssseeee,,,,$$$$nnnnoooonnnnoooonnnnoooo))));;;;
  17.  
  18.      ppppmmmm____ttttoooo____bbbblllliiiibbbb(((($$$$hhhhaaaasssshhhhrrrreeeeffff))));;;;
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      Both _i_n_s_t_a_l_l() and _u_n_i_n_s_t_a_l_l() are specific to the way
  22.      ExtUtils::MakeMaker handles the installation and deinstallation of perl
  23.      modules. They are not designed as general purpose tools.
  24.  
  25.      _i_n_s_t_a_l_l() takes three arguments. A reference to a hash, a verbose switch
  26.      and a don't-really-do-it switch. The hash ref contains a mapping of
  27.      directories: each key/value pair is a combination of directories to be
  28.      copied. Key is a directory to copy from, value is a directory to copy to.
  29.      The whole tree below the "from" directory will be copied preserving
  30.      timestamps and permissions.
  31.  
  32.      There are two keys with a special meaning in the hash: "read" and
  33.      "write". After the copying is done, install will write the list of target
  34.      files to the file named by $hashref->{write}. If there is another file
  35.      named by $hashref->{read}, the contents of this file will be merged into
  36.      the written file. The read and the written file may be identical, but on
  37.      AFS it is quite likely, people are installing to a different directory
  38.      than the one where the files later appear.
  39.  
  40.      _i_n_s_t_a_l_l__d_e_f_a_u_l_t() takes one or less arguments.  If no arguments are
  41.      specified, it takes $ARGV[0] as if it was specified as an argument. The
  42.      argument is the value of MakeMaker's FULLEXT key, like _T_k/_C_a_n_v_a_s. This
  43.      function calls _i_n_s_t_a_l_l() with the same arguments as the defaults the
  44.      MakeMaker would use.
  45.  
  46.      The argumement-less form is convenient for install scripts like
  47.  
  48.        perl -MExtUtils::Install -e install_default Tk/Canvas
  49.  
  50.      Assuming this command is executed in a directory with populated _b_l_i_b
  51.      directory, it will proceed as if the _b_l_i_b was build by MakeMaker on this
  52.      machine.  This is useful for binary distributions.
  53.  
  54.      _u_n_i_n_s_t_a_l_l() takes as first argument a file containing filenames to be
  55.      unlinked. The second argument is a verbose switch, the third is a no-
  56.      don't-really-do-it-now switch.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. EEEExxxxttttUUUUttttiiiillllssss::::::::IIIInnnnssssttttaaaallllllll((((3333))))                                      EEEExxxxttttUUUUttttiiiillllssss::::::::IIIInnnnssssttttaaaallllllll((((3333))))
  71.  
  72.  
  73.  
  74.      _p_m__t_o__b_l_i_b() takes a hashref as the first argument and copies all keys of
  75.      the hash to the corresponding values efficiently. Filenames with the
  76.      extension pm are autosplit. Second argument is the autosplit directory.
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.